home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / wrap10.zip / WRAPPER.DOC < prev    next >
Text File  |  1992-09-01  |  8KB  |  195 lines
  1.  
  2. ================================================================================
  3.        WRAPPER.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  4.        WRAPP86.SYS (8086):  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  5. ================================================================================
  6.  
  7.   WRAPPER.SYS is a device driver which enables the loading of programs in
  8.   the CONFIG.SYS file as devices.  The program may be a Terminate-and-
  9.   Stay Resident utility (TSR) or a program which simply executes but does
  10.   not stay resident.  The driver DEBUGNXT.SYS is a companion to wrapper
  11.   which complements WRAPPER's special support for loading debuggers, like
  12.   MS-DOS's DEBUG.  By loading a debugger in the config.sys, programmers
  13.   may trace and debug the initialization of device drivers.  High memory
  14.   users may load WRAPPER and/or DEBUGNXT into high memory with a device
  15.   loader, or using MS-DOS 5.0's DEVICEHIGH command.
  16.  
  17. ================================================================================
  18.  
  19. (Requirements)::
  20.  
  21.         * 186 processor or better (WRAPP86.SYS and DEBUGN86.SYS are
  22.           included to support 8086/8088 processors)
  23.         * Requires MS-DOS Version 3.1 or better
  24.  
  25. ================================================================================
  26.  
  27. (Installation)::
  28.  
  29.         (CONFIG.SYS)::
  30.  
  31.         Install WRAPPER.SYS in your CONFIG.SYS as a DEVICE
  32.  
  33.         DEVICE=WRAPPER.SYS [options] program.exe (or .com) [program options]
  34.  
  35.         All switch options and possible messages for WRAPPER are detailed
  36.         below:
  37.  
  38. ================================================================================
  39.  
  40. (Syntax)::
  41.  
  42.         The only thing to remember about syntax for the command line is
  43.         that just about anything works.  What this means is that you
  44.         should be able to type in the options on the command line the
  45.         way they make sense to you.
  46.  
  47.         To illustrate this point, the following command line example
  48.         is mutated several different ways.
  49.  
  50.         DEVICE=WRAPPER.SYS /R- /P- /M4 MYPROG.EXE
  51.         DEVICE=WRAPPER.SYS -R- -P- -M4 MYPROG.EXE
  52.         DEVICE=WRAPPER.SYS -R--P-M4 MYPROG.EXE
  53.  
  54.         ... and so on.
  55.  
  56. (Switch Options)::
  57.  
  58.         (REPORT)::      R[+ or -]       (toggle:  default +)
  59.  
  60.         Use /R- to disable messages from WRAPPER.SYS.
  61.  
  62.         (PAUSE)::       P[+ or -]       (toggle:  default +)
  63.  
  64.         Use /P+ to enable the pause after the any report messages.
  65.  
  66.         (NOPAUSE)::     N[+ or -]       (toggle:  default -)
  67.  
  68.         Use /N+ to never pause after the report, even if there
  69.         are errors.  This switch can be used if your configuration
  70.         generates a warning or error message which you choose to ignore.
  71.  
  72.         (DEBUGINT)::    D[xx]           (hex value:  default ?)
  73.  
  74.         Use /Dxx to tell WRAPPER to hook a user interrupt.  This is
  75.         especially useful to ease the use of a debugger like MS-DOS's
  76.         DEBUG.  A user vector is hooked by WRAPPER in the range of
  77.         int 60h - 67h.  The target of the interrupt is the code necessary
  78.         to keep the debugger resident.
  79.  
  80.            DEVICE=WRAPPER.SYS /C-/D/M32 C:\DEBUG.EXE
  81.            DEVICE=DEBUGNXT.SYS
  82.            DEVICE=MYDEVICE.SYS
  83.  
  84.            (Display at boot-up):
  85.  
  86.            WRAPPER.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  87.                        :  User interrupt 60h hooked
  88.  
  89.            (Debug's prompt):
  90.  
  91.            -a 100                               ; assemble at 0100
  92.            1234:0100 int 60                     ; the instruction "int 60"
  93.            -g                                   ; go
  94.  
  95.            DEBUGNXT.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  96.  
  97.            (Stops at first instruction of MYDEVICE's strategy routine):
  98.  
  99.            AX=0000 BX=03E6 CX=0000 DX=0000 SP=05A6 BP=0000 SI=0000 DI=0000
  100.            DS=0C96 ES=9087 SS=9087 CS=0C96 IP=0016 NV UP EI PL NZ NA PO NC
  101.            0C96:0016 2E            CS:
  102.            0C96:0017 891E1200      MOV     [0012],BX          CS:0012=0000
  103.            -
  104.  
  105.         When you use /D with no hexadecimal parameter, WRAPPER will search
  106.         for the 1st available interrupt.  You may also specify the interrupt 
  107.         to use (if not in use already),  for example, /D63.  A valid input is
  108.         a hexadecimal number between 60h and 67h.
  109.  
  110.         (CLOSE HANDLE 0)::      C[+ or -]       (toggle:  default +)
  111.  
  112.         Use /C- to tell WRAPPER not to close file handle 0 (CON input/output)
  113.         after the specified program or TSR returns.  This is useful for
  114.         programs which expect to write/read to STDOUT/STDIN after CONFIG.SYS.
  115.         MS-DOS normally rearranges the file handles after CONFIG.SYS, so that
  116.         AUX is handle 0.  If the program uses to handle 0 after CONFIG.SYS,
  117.         the input/output will use AUX instead of CON.  This will cause a
  118.         critical error (or interfere with communications), unless this switch
  119.         is used.  MS-DOS's DEBUG is a good example of a program which
  120.         requires this switch, and then only if an INT 03h (Trap interrupt) is
  121.         encountered after CONFIG.SYS.  See the DEBUGINT example above.
  122.         
  123.         (MEMORY LIMIT)::        M[nnn]          (value:  default ?)
  124.  
  125.         Use /Mnnn to specify the amount of memory to limit a program to use.
  126.         This switch is useful when loading a TSR high, or when loading a
  127.         non-tsr like DEBUG, so that all available memory is not allocated by
  128.         the program.  The value, nnn is in 1 Kbyte units, so /M32 would be
  129.         limit the memory used by the program to 32K.  See the DEBUGINT example
  130.         above.  The default (/M) is to use all memory available.
  131.  
  132.         *  everything in square brackets "[]" is optional
  133.  
  134. (CONFIG.SYS Line)::
  135.  
  136.         DEVICE=WRAPPER.SYS [/Dxx][/C-][/R-][/P+][/N-][/Mnnn]
  137.  
  138.         device default:  /C+/R+/P-/N-/M?
  139.  
  140.         *  Don't hook a User Interrupt
  141.         *  Close File Handle 0
  142.         *  Report status messages
  143.         *  Don't Pause after report
  144.         *  Pause on errors or warnings
  145.         *  Use all memory available
  146.  
  147. ================================================================================
  148.  
  149. (Report Format)::
  150.  
  151.         WRAPPER.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  152.               ERROR :  (Error Messages)
  153.             WARNING :  (Warning Messages)
  154.              ADVICE :  (Advisory Messages)
  155.                     :  (Report Messages)
  156.                     :  (Allocation Status)
  157.               PAUSE :  Press any key to continue... 
  158.  
  159. ================================================================================
  160.  
  161. (Error Messages)::
  162.  
  163.         MS-DOS version 3.10 or above is required
  164.         An 80186 processor or better is required
  165.         Bad or missing program specification
  166.         User Interrupts 60h - 67h are in use
  167.  
  168. ================================================================================
  169.  
  170. (Warning Messages)::
  171.  
  172.         Unknown option in command line
  173.         Extra characters on command line
  174.  
  175. ================================================================================
  176.  
  177. (Advisory Messages)::
  178.  
  179. ================================================================================
  180.  
  181. (Report Messages)::
  182.  
  183.         User interrupt 00h hooked
  184.         Invalid Parameter for /D 00
  185.  
  186. ================================================================================
  187.  
  188. (Allocation Status)::
  189.  
  190. ================================================================================
  191.  
  192. (Changes)::
  193.  
  194. ================================================================================
  195.